home *** CD-ROM | disk | FTP | other *** search
/ Aminet 7 / Aminet 7 - August 1995.iso / Aminet / misc / math / pari_1_38_3.readme < prev   
Encoding:
Text File  |  1995-07-02  |  11.8 KB  |  280 lines
  1. Short:    Linear algebra and number theory. Src.
  2. Author:   pari@ceremab.u-bordeaux.fr
  3. Uploader: nisse@lysator.liu.se
  4. Type:     misc/math
  5.  
  6. About PARI             (14 dec 1993)
  7. ----------
  8.  
  9. PARI is the name of a sophisticated and free math package. GP is a
  10. calculator that offers all the features of PARI and some more. PARI
  11. uses *infinite* precision rational numbers and *arbitrary* precision
  12. floating point numbers. 
  13.  
  14. You can use complex numbers, vectors, matrices, polynomials, rational
  15. functions and taylor expansions. PARI also handles integers mod n,
  16. finite fields, algebraic numbers and p-adic numbers. PARI includes
  17. standard numerical methods and the GP calculator also includes
  18. hi-resolution plotting.
  19.  
  20. PARI is written by four professional number theorists, C. Batut, 
  21. D. Bernardi, H. Cohen and M. Olivier. The latter two are Professors of
  22. Mathematics.
  23.  
  24. -------
  25.  
  26. This amiga distribution contains the GP calculator compiled for
  27. different processors, an emacs mode for running GP, partial
  28. documentation, and all the amiga specific files I used to compile GP.
  29. The amiga hi-resolution plotting functions are written by Jerry
  30. Tunnell, who kindly let me use and distribute them.
  31.  
  32. If you want full source and documentation, you will have to get the
  33. source distribution. It *should* be available where you found this
  34. package, as file pari-1.38.3.tar.gz or something similar (*Please* keep
  35. this archive and the source archive together. If you like GP, you will
  36. probably want the documentation too). If you can't find the source
  37. anywhere else, you can try to ftp to megrez.ceremab.u-bordeaux.fr,
  38. directory pub/pari/unix. This is the main PARI site.
  39.  
  40.  
  41. Files
  42. -----
  43.   
  44. amiga/             Amiga specific files and sources.
  45.     makefile.68000     Makefiles for different amiga versions.
  46.     makefile.68020 
  47.     makefile.68881
  48.     mpAmiga.s     Assembler file (gcc syntax) for the 68020 versions.
  49.              Converted from mp.s with the convert68k.el program in
  50.              the elisp directory.    
  51.     plotAmiga.c     Hi-resolution plotting functions, written by J.B. Tunnell.
  52.     version68k.diff  Source diffs to add an Amiga version string.
  53.     versionport.diff
  54.  
  55. bin/
  56.     gp.68000     GP binaries for different processors.
  57.     gp.68020
  58.     gp.68881
  59.  
  60. doc/             This directory does not contain the complete documentation,
  61.     usersch3.tex     only one file that is needed by pari.el
  62.  
  63. elisp/
  64.     convert68k.el     Elisp program to convert a sun3 style 68k assembler file
  65.              (read mp.s) into something that amiga gcc can understand.
  66.     pari.el         An Emacs mode for the GP calculator. Desribed below and
  67.     pari.elc     in the file pari.txt
  68.     pari.menu     Used by pari.el.
  69.     pari.txt     A description of pari-mode
  70.  
  71. examples/
  72.     EXPLAIN         Description of the examples.
  73.     Makefile     Note that you cannot compile the C example
  74.     Makesimple     without the libpari.a library.
  75.     bench.gp
  76.     clareg.gp
  77.     lucas.gp
  78.     mattrans.c
  79.       rho.gp
  80.     squfof.gp
  81.       tutnf.gp
  82.     tutnfout
  83.  
  84.  
  85. Starting PARI
  86. -------------
  87.  
  88. First, you need to install Markus Wild's ixemul.library, if you don't
  89. have it already. Version 39.45 is the most recent non-buggy version I
  90. know of (39.47 seems to be unreliable). This library is available on
  91. Aminet (for example at ftp.luth.se) and is included in the gcc
  92. distribution.
  93.  
  94. GP (file gp.68020 or whichever version you use) takes three command line
  95. options. The most important is '-s STACKSIZE'. This sets the initial
  96. size of the internal PARI stack (not to be confused with the task
  97. stack). The default value is 4 MB which may be more RAM than you have
  98. available. Try 'gp -s 1000000' or 'gp -s 100000' if GP refuses to
  99. start. The other two flags are '-p PRIMELIMIT' and '-b BUFFERSIZE'.
  100. Default values are 500000 and 30000 respectively.
  101.  
  102. Talking about the task stack, I don't know exactly how large it must
  103. be. I use a stack of 100000 bytes, and that seems to be enough. To set
  104. the task stack, use the command 'STACK 100000' command from the shell,
  105. not the -s option to GP.
  106.  
  107. At the pari command prompt (default '?'), \q or CTRL-\ exits GP. You
  108. can type '?' to get some on-line help. Note that running GP inside
  109. emacs gives you better online help.
  110.  
  111. The GP command interface is quite straight forward if you are used to
  112. MATLAB or similar systems. Note that with GP both vectors and matrices
  113. are typed with with square brackets '[' ']', with comma ',' separating
  114. elements on the same row and semicolon ';' separating rows. For
  115. example, a 2-2 matrix is typed '[1,2 ; 3,4]'.
  116.  
  117. The emacs mode.  
  118. --------------- 
  119. To use this on the amiga, you must make sure that you have mounted the
  120. FIFO: device, and that the SHELL environment variable is set to some
  121. unix-style shell. I use the shell distributed with gcc, a port of
  122. pdksh (file name gcc/bin/sh). The shell distributed with GNUemacs
  123. might work too, but I haven't tried it. The emacs mode is described in
  124. the file elisp/pari.txt. If you don't wan't to edit the pari.el file,
  125. you should assign PARI: to the directory where you have installed
  126. PARI.
  127.  
  128. Known bugs
  129. ----------
  130. GP does not respond to CTRL-C when run from the shell. However, if you
  131. send the CTRL-C signal from another shell window (with the BREAK
  132. command) or type CTRL-C in GP's emacs buffer, GP is interrupted.
  133.  
  134. A free() call occasionally failes when using the 68000 or 68020
  135. versions of GP. I have not had this problem with the 68881 version.
  136.  
  137. I'm tempted to blame both these problems on the ixemul.library, but
  138. I'm not sure what happens.  
  139.  
  140. For those who are curious about the differences between the three
  141. versions gp.68000, gp.68020 and gp.68881: 
  142.  
  143. * The first two are compiled with gcc -msoftfloat instead of gcc
  144. -m68881. If a 68881 processor is present, all three version makes use
  145. of it. The performance difference between the gp.68020 and the 68881
  146. version should be rather small on any machine that can run both. I
  147. included the 68881 because it seemes more reliable.
  148.  
  149. * In the 68020 and 68881 versions, some low level functions are
  150. written in 68020 assembler, while the 68000 version is written
  151. entirely in C and is compiled with gcc -m68000 to make sure that it
  152. contains only 68000 instructions.
  153.  
  154. ------- 
  155. Enjoy GP!
  156.  
  157. Feel free to send me comments and questions (and even bug reports).
  158.     Niels Möller
  159.     Ställdalsvägen 11
  160.     122 43 Enskede
  161.     SWEDEN
  162. email:    nisse@lysator.liu.se
  163.  
  164. For questions and bug reports not specific to the amiga version, you
  165. can also write to the authors:
  166.     pari@ceremab.u-bordeaux.fr
  167.  
  168.  
  169. ============================= Archive contents =============================
  170.  
  171. Original  Packed Ratio    Date     Time    Name
  172. -------- ------- ----- --------- --------  -------------
  173.        0       0  0.0% 03-Dec-93 12:21:00 +
  174.      439     197 55.1% 04-Jul-93 13:15:02 +Makefile
  175.    11937    4883 59.0% 02-Nov-93 07:22:28 +appa.tex
  176.      683     397 41.8% 07-Feb-93 04:23:50 +appb.tex
  177.     2090    1028 50.8% 07-Feb-93 04:23:50 +appc.tex
  178.     2155     997 53.7% 07-Feb-93 04:23:50 +appd.tex
  179.      353     194 45.0% 03-Dec-93 12:20:46 +titlepage.tex
  180.   109788   41647 62.0% 03-Dec-93 12:18:36 +tutorial.tex
  181.     4307    1585 63.1% 03-Dec-93 12:21:00 +users.tex
  182.    17664    7135 59.6% 07-Aug-93 17:56:46 +usersch1.tex
  183.    24576    9193 62.5% 24-Oct-93 19:02:06 +usersch2.tex
  184.   186465   56863 69.5% 25-Nov-93 17:43:22 +usersch3.tex
  185.    57901   21358 63.1% 05-Nov-93 11:49:34 +usersch4.tex
  186.    31799    8153 74.3% 07-Feb-93 04:23:54 +usersch5.tex
  187.        0       0  0.0% 03-Dec-93 12:20:06 +
  188.     3319    1602 51.7% 01-Nov-93 18:29:14 +EXPLAIN
  189.      182     136 25.2% 04-Nov-93 03:53:16 +Makefile
  190.      151     129 14.5% 05-Nov-93 11:52:34 +Makesimple
  191.      100      84 16.0% 05-Aug-93 12:33:36 +bench.gp
  192.     2169    1108 48.9% 01-Nov-93 18:30:14 +clareg.gp
  193.       52      52  0.0% 05-Aug-93 12:33:16 +lucas.gp
  194.     1483     805 45.7% 02-May-93 17:06:40 +mattrans.c
  195.      260     149 42.6% 05-Aug-93 12:36:46 +rho.gp
  196.      709     394 44.4% 07-Feb-93 04:24:20 +squfof.gp
  197.     1745     856 50.9% 03-Dec-93 12:16:48 +tutnf.gp
  198.     7956    3049 61.6% 03-Dec-93 12:19:08 +tutnfout
  199.        0       0  0.0% 03-Dec-93 12:22:56 +
  200.     1186     668 43.6% 01-Nov-93 18:44:26 +Buglist
  201.     5345    2399 55.1% 28-Nov-93 13:11:10 +Changes
  202.    47459   19307 59.3% 18-Jul-93 14:24:34 +Changes1.31-1.35
  203.    41438   15641 62.2% 18-Sep-93 13:20:16 +Changes1.35-1.38
  204.    13637    4400 67.7% 03-Dec-93 12:24:14 +FILES
  205.    11069    4646 58.0% 01-Nov-93 19:27:10 +INSTALL
  206.     8208    2625 68.0% 25-Nov-93 16:28:46 +Makemakefile
  207.    10749    4518 57.9% 18-Jul-93 14:24:34 +Newin1.37
  208.     7479    3154 57.8% 06-Sep-93 18:00:34 +Newin1.38
  209.     3265    1495 54.2% 28-Nov-93 18:04:40 +Newin1.39
  210.     3086    1616 47.6% 01-Nov-93 18:48:50 +README
  211.      534     319 40.2% 01-Nov-93 18:45:16 +TODO
  212.    50860   10432 79.4% 20-Nov-93 10:35:28 +alglin1.c
  213.    36625    8149 77.7% 20-Nov-93 07:30:16 +alglin2.c
  214.    48731   11140 77.1% 25-Nov-93 17:34:02 +anal.c
  215.    49560   12108 75.5% 26-Nov-93 19:01:52 +arith1.c
  216.    35536    8012 77.4% 11-Nov-93 05:53:04 +arith2.c
  217.    51522   12575 75.5% 26-Nov-93 18:56:00 +base1.c
  218.    70244   17536 75.0% 02-Dec-93 08:02:22 +base2.c
  219.    70962   14319 79.8% 12-Nov-93 10:33:50 +bibli1.c
  220.    51129   10511 79.4% 25-Aug-93 09:27:54 +bibli2.c
  221.    50995   11862 76.7% 27-Nov-93 05:30:18 +buch1.c
  222.    49167   13191 73.1% 02-Dec-93 08:03:24 +buch2.c
  223.     1001     225 77.5% 25-Nov-93 17:45:10 +dummy.c
  224.      274     122 55.4% 02-Dec-93 11:34:50 +dummybuch.c
  225.    64183   18663 70.9% 26-Nov-93 19:05:36 +elliptic.c
  226.     5573    2011 63.9% 04-Aug-93 16:53:26 +erreurs.h
  227.    20239    5206 74.2% 26-Nov-93 18:07:18 +errmessages.c
  228.    39677    8067 79.6% 03-Dec-93 12:21:26 +es.c
  229.    48191    9221 80.8% 30-Nov-93 18:35:06 +gen1.c
  230.    56205   10648 81.0% 02-Dec-93 11:40:04 +gen2.c
  231.    54397   10813 80.1% 01-Dec-93 07:48:38 +gen3.c
  232.     5040     974 80.6% 25-Aug-93 09:30:44 +gen68k.h
  233.     1467     372 74.6% 28-Nov-93 12:46:50 +gen68kplus.h
  234.    37638    9307 75.2% 30-Nov-93 19:21:58 +gencom.h
  235.      434     143 67.0% 28-Nov-93 12:49:16 +genpari68k.h
  236.      462     148 67.9% 04-Aug-93 16:53:28 +genpariother.h
  237.     5144    1061 79.3% 16-Sep-93 06:04:36 +genport.h
  238.      942     558 40.7% 18-Jul-93 14:24:42 +gp.1
  239.    16271    4831 70.3% 23-Nov-93 04:10:02 +gp.c
  240.    18010    5279 70.6% 23-Nov-93 04:10:34 +gpreadline.c
  241.    35879   11255 68.6% 25-Nov-93 17:38:30 +helpmessages.c
  242.     3635     915 74.8% 04-Aug-93 16:53:28 +hppa.s
  243.     6651    1315 80.2% 15-Nov-93 04:48:42 +i386.c
  244.    13444    4155 69.0% 04-Nov-93 07:19:10 +init.c
  245.   163665   35694 78.1% 28-Nov-93 12:58:06 +mp.ami
  246.    38226    9454 75.2% 01-Dec-93 09:16:30 +mp.c
  247.   124388   23306 81.2% 28-Nov-93 12:54:50 +mp.news
  248.   249494   39653 84.1% 28-Nov-93 12:58:24 +mp.s
  249.     2406     591 75.4% 25-Aug-93 09:33:40 +mpansi.h
  250.    29627    7871 73.4% 26-Aug-93 06:58:56 +mpin.c
  251.     9557    2159 77.4% 26-Aug-93 06:59:46 +mpin.h
  252.    25732    7841 69.5% 18-Jul-93 14:24:48 +pari.el
  253.    20582    7580 63.1% 18-Jul-93 14:24:48 +pari.el-changes
  254.    16604    6282 62.1% 18-Jul-93 14:24:50 +pari.elc
  255.     3710    1621 56.3% 06-Nov-93 11:46:46 +pari.menu
  256.     9737    3701 61.9% 18-Jul-93 14:24:50 +pari.txt
  257.    16210    3345 79.3% 27-Nov-93 05:18:24 +plotX.c
  258.      274     122 55.4% 25-Aug-93 09:34:22 +plotnull.c
  259.    12724    3020 76.2% 04-Aug-93 16:53:28 +plotsun.c
  260.    72457   16604 77.0% 21-Nov-93 17:44:36 +polarit1.c
  261.    42898   10726 74.9% 29-Oct-93 16:40:34 +polarit2.c
  262.     9975    1898 80.9% 04-Aug-93 16:53:28 +sparcv7.s
  263.     7253    1890 73.9% 18-Jul-93 14:24:52 +sparcv8.s
  264.     2837     655 76.9% 24-Jul-93 14:05:16 +sparcv8micro.s
  265.     7253    1890 73.9% 18-Jul-93 14:24:52 +sparcv8super.s
  266.    10847    4607 57.5% 25-Nov-93 17:46:58 +testin
  267.    59723   22241 62.7% 02-Dec-93 08:30:50 +testout
  268.      739     285 61.4% 18-Jul-93 14:24:52 +testplotin
  269.    34157    7665 77.5% 10-Nov-93 16:52:02 +trans1.c
  270.    44775    7194 83.9% 26-Aug-93 07:02:42 +trans2.c
  271.    32671    8059 75.3% 23-Nov-93 04:27:06 +trans3.c
  272.      163     116 28.8% 15-Nov-93 04:48:42 +version386.c
  273.     5058    1828 63.8% 24-Oct-93 19:07:16 +version68k.c
  274.      328     173 47.2% 24-Oct-93 19:07:02 +versionhp.c
  275.     3942    1149 70.8% 24-Oct-93 19:06:52 +versionport.c
  276.      332     178 46.3% 24-Oct-93 19:06:36 +versionsparcv7.c
  277.      332     177 46.6% 24-Oct-93 19:06:16 +versionsparcv8.c
  278. -------- ------- ----- --------- --------
  279.  2680502  697481 73.9% 08-Jun-95 15:41:32   105 files
  280.